home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / bbs / gangl30.zip / GANGL30.EXE / DOCS / GANGLAND.DOC < prev    next >
Text File  |  1997-08-19  |  15KB  |  325 lines
  1.             ─────────────────────────────────────────────────────
  2.                                GANGLAND WARS  
  3.                                    
  4.                                    v3.0
  5.                                    
  6.                         (C)1997 Sunrise Door Software
  7.                              
  8.                                 Al Lawrence
  9.  
  10.                                 Sunrise -80 BBS
  11.                              (404) 256-9525 (BBS)
  12.                      (404) 256-9518 (VOICE, 9a-9:30p EST/EDT)
  13.                      Email: al_lawre@ix.netcom.com
  14.                      WWW  : http://www.netcom.com/~al_lawre
  15.      
  16.             ─────────────────────────────────────────────────────
  17.                             GANGLAND WARS Features:
  18.             ─────────────────────────────────────────────────────
  19.  
  20.              - DROP FILE SUPPORT:
  21.                ─────────────────
  22.                 
  23.                 - DOOR.SYS       (DOOR.SYS compatible systems)
  24.                 - DORINFOx.DEF   (QBBS/RBBS/Remote Access systems)
  25.                 - PCBOARD.SYS    (PCBOARD systems)
  26.                 - SFDOORS.DAT    (Spitfire systems)
  27.                 - CALLINFO.BBS   (Wildcat previous to v3.0 systems)
  28.         
  29.              - MULTINODE SUPPORT:
  30.                ───────────────── 
  31.                 
  32.                 - Error handling routines to save data from becoming corrupt
  33.                 - Files accessed quickly and effeciently
  34.                 - Read-only files opened in shared mode for quicker operation
  35.                 - Highly used data files are copied to a temp data file with
  36.                   a node number extension to free up these files for other 
  37.                   processes
  38.  
  39.              - EASY INSTALL & CONFIGURATION UTILITY ALLOWS YOU TO:
  40.                ──────────────────────────────────────────────────  
  41.                 
  42.                 - Install GANGLAND WARS quickly & easily
  43.                 - Reconfigure nodes quickly & easily
  44.                 - Reset the game
  45.                 - Featuring FULL MOUSE Support
  46.                 - Easy Node to Node passing of entries
  47.              
  48.              - GAME SPECIFIC FEATURES:
  49.                ──────────────────────  
  50.                 
  51.                 - Includes external AIP (Computer Players) Module
  52.                   to add 10 Computer Players to your game
  53.                 - No annoying delays in UNREGISTERED door
  54.                 - No DEMO KEY FILES required
  55.                 - Checking for user entered BADWORDS(can be disabled)
  56.                 - Tested under a variety of operating systems including:
  57.                   DOS, OS/2, DESQview, WINDOWS 3.x and WINDOWS 95
  58.  
  59.              
  60.              
  61.              TABLE OF CONTENTS
  62.             ─────────────────────────────────────────────────────
  63.              Warranty...........................................1
  64.              Usage..............................................2
  65.              Distribution.......................................3
  66.              Description........................................4
  67.              Registration Information...........................5
  68.              Shareware vs Registered............................6
  69.              System Requirements................................7
  70.              Installation.......................................8
  71.              Running the Program................................9
  72.              Fossil Driver Support.............................10
  73.              Environment Variables.............................11
  74.              Up & Running......................................12
  75.              User Entered Bad Words............................13
  76.              Errors & Other Problems...........................14
  77.             ─────────────────────────────────────────────────────
  78.  
  79.  
  80.      
  81.      ┌─WARRANTY────────────────────────────────────────────────────1─┐
  82.      └───────────────────────────────────────────────────────────────┘
  83.  
  84.      This product is provided "as is" without warranty of any kind. 
  85.      The entire risk as to the results and performance of the program 
  86.      is assumed by you.  Futhermore, the author does not warrant, 
  87.      guarantee, or make any other representations regarding the use 
  88.      of, or the results of the use of the program, and you rely on the 
  89.      program and results solely at your own risk. The author cannot 
  90.      and will not accept responsibility for system damage, loss of 
  91.      profit, or any other special, consequential or incidental damages 
  92.      resulting from the use or inability to use this product.
  93.  
  94.  
  95.      ┌─USAGE───────────────────────────────────────────────────────2─┐
  96.      └───────────────────────────────────────────────────────────────┘
  97.  
  98.      This product is being distributed as Shareware. Under this 
  99.      concept you may use the SHAREWARE (unregistered) version for a 
  100.      reasonable period for evaluation, after which you MUST either 
  101.      register your copy or discontinue usage.  
  102.  
  103.      
  104.      ┌─DISTRIBUTION────────────────────────────────────────────────3─┐
  105.      └───────────────────────────────────────────────────────────────┘
  106.  
  107.      You are encouraged to distribute this copy of GANGLAND WARS 
  108.      provided the archive is kept in its original and unmodified 
  109.      state.  This is ensured by the AV STAMP on the archive from 
  110.      Lounge Software.
  111.  
  112.  
  113.      ┌─DESCRIPTION─────────────────────────────────────────────────4─┐
  114.      └───────────────────────────────────────────────────────────────┘
  115.  
  116.      GANGLAND WARS is a Multinode, RPG style door game that allows
  117.      users to be a Gang Leader and do various things each day they
  118.      log onto the BBS.
  119.  
  120.  
  121.      ┌─REGISTRATION─INFORMATION────────────────────────────────────5─┐
  122.      └───────────────────────────────────────────────────────────────┘
  123.  
  124.      There are a couple of ways in which you can register GANGLAND 
  125.      WARS and receive your individual key file, which will allow the 
  126.      program to operate in FULL registered mode.  Look for details on 
  127.      how to do this in the file: REGISTER.FRM included with this 
  128.      archive.
  129.  
  130.  
  131.      ┌─SHAREWARE─VS─REGISTERED─────────────────────────────────────6─┐
  132.      └───────────────────────────────────────────────────────────────┘
  133.  
  134.      THERE ARE NO DEMO KEYS REQUIRED IN THE UNREGISTERED version of 
  135.      GANGLAND WARS.  The SHAREWARE version of GANGLAND WARS has a 
  136.      couple of limitations as opposed to the REGISTERED version.  
  137.      Users can only reach level 5 before their stats are reset.  The 
  138.      game CANNOT be won in UNREGISTERED MODE!  As well, the standard 
  139.      configuration will be used unless the game is registered.  
  140.      Ex.  Punk Fights, Blackjack Hands etc.   
  141.  
  142.      These limitations are not in place to be annoying, just to 
  143.      encourage registration of the product to cover the cost of 
  144.      programming time and support.  
  145.                               
  146.  
  147.      ┌─SYSTEM─REQUIREMENTS─────────────────────────────────────────7─┐
  148.      └───────────────────────────────────────────────────────────────┘
  149.  
  150.      ANSI.SYS MUST be loaded in your CONFIG.SYS.  Users who are using 
  151.      some other type of ANSI emulation may get the system to work...
  152.      Ex. DVANSI.  This should be loaded at system boot up, not just in 
  153.      each process or window.
  154.      
  155.      SHARE.EXE MUST be loaded in your CONFIG.SYS.
  156.  
  157.      DOS 5.0 or later.
  158.  
  159.  
  160.      ┌─INSTALLATION────────────────────────────────────────────────8─┐
  161.      └───────────────────────────────────────────────────────────────┘
  162.  
  163.      Installation of GANGLAND WARS is very simple.  Move the 
  164.      GANGWxx.ZIP file into whatever directory you plan to run GANGLAND 
  165.      WARS from and UNZIP GANGWxx.  Run GANGWxx.EXE and it will 
  166.      automatically create the subdirectories it needs to operate, so 
  167.      moving it to its planned directory is the way to go here.
  168.  
  169.      Type "GANGCFG" at the DOS Prompt in your GANGLAND WARS 
  170.      directory.  This will start GANGLAND WARS CONFIGURATION UTILITY 
  171.      and get you on your way.  The program is very self explanatory.
  172.  
  173.      You can use your arrow keys to move around as well as your TAB
  174.      key if you prefer to use the keyboard.  ENTER will select an
  175.      item.  The Configuration Utility features full MOUSE support as
  176.      well if you prefer a mouse.
  177.      
  178.      When configuring for each node in GANGCFG.EXE, it will create a 
  179.      NODEx.CFG file for each node, where x represents the node number.
  180.  
  181.      Add a call to GWMAINT.EXE in your nightly event batch file.  
  182.      GWMAINT.EXE NEEDS to be called once a night.  GWMAINT.EXE will
  183.      delete inactive players.  Players are deleted after 14 days of 
  184.      inactivity.  GWMAINT will also ressurect all players for that day.
  185.      GWMAINT.EXE is fully multinode as well and can be run even if 
  186.      someone is in the game.  Be sure that GWMAINT.EXE resides in your 
  187.      main GANGLAND WARS directory and you change to that directory, 
  188.      before you call GWMAINT.
  189.      
  190.      If you wish to add any Computer Players (AIP's) to your game, 
  191.      please see GWAIP.DOC also in this directory for installation and
  192.      operating procedures.
  193.      
  194.      
  195.      ┌─RUNNING─THE─PROGRAM─────────────────────────────────────────9─┐
  196.      └───────────────────────────────────────────────────────────────┘
  197.  
  198.      This part is basically up to you.  Depending on which BBS program 
  199.      you are running, the .BAT file may look a little different.  
  200.      Refer to your BBS Manual for information on running Doors from 
  201.      your BBS.  We will use a sample .BAT file which would run 
  202.      GANGLAND WARS from a Wildcat System:
  203.  
  204.      DOOR10.BAT
  205.      ──────────
  206.  
  207.      CD\DOORS\GANGLAND              <- Call to directory
  208.      GANGLAND NODEx.CFG             <- Call to main .EXE and .CFG file
  209.      CD\WILDCAT                     <- Call back to the BBS
  210.  
  211.  
  212.      The x reflects the NODE NUMBER that the program is being called 
  213.      from.  The DEFAULT is NODE1.CFG.  If you are running a single 
  214.      line BBS, then this is the number you should be using.
  215.  
  216.  
  217.      ┌─FOSSIL─DRIVER─SUPPORT──────────────────────────────────────10─┐
  218.      └───────────────────────────────────────────────────────────────┘
  219.  
  220.      GANGLAND WARS also supports the use of Fossil drivers.  To tell 
  221.      it to use the Fossil Driver instead of the standard COM ports, 
  222.      just put /FD on the command line when running the door. For 
  223.      example:
  224.      
  225.      GANGLAND NODEx.CFG /FD
  226.  
  227.      indicates that a Fossil driver is present and should be used. 
  228.      
  229.      *** NOTE:  No fossil driver is needed to run this door.  If you 
  230.                 are operating on standard COM ports and IRQ's, then 
  231.                 use of the fossil driver is NOT REALLY NEEDED.
  232.  
  233.  
  234.      ┌─ENVIRONMENT─VARIABLES──────────────────────────────────────11─┐
  235.      └───────────────────────────────────────────────────────────────┘
  236.  
  237.      GANGLAND WARS supports COM 1 - 4 on the standard IRQ's - 
  238.      COM1/COM3 = IRQ4 and COM2/COM4 = IRQ3.  GANGLAND WARS WILL support 
  239.      COM 0 - 15.  If you wish to use a non-standard IRQ, add the IRQ 
  240.      number after the configuration filename.  Let's assume you want 
  241.      to use COM1 and IRQ5. The command line passed in the .BAT file 
  242.      would be:
  243.     
  244.      GANGLAND NODEx.CFG /5  or
  245.      GANGLAND NODEx.CFG /%IRQ%   <- for an environment variable.
  246.  
  247.      The /5 tells GANGLAND to use IRQ5 rather than the standard 
  248.      IRQ4 that is normally used with COM1. No /x parameter is needed 
  249.      for the standard IRQ's.
  250.  
  251.  
  252.      ┌─UP─AND─RUNNING─────────────────────────────────────────────12─┐
  253.      └───────────────────────────────────────────────────────────────┘
  254.  
  255.      Once GANGLAND WARS is up and running it should basically take 
  256.      care of itself and will require no maintenance from you, other 
  257.      than the daily call to GWMAINT.EXE.  Instructions on using the 
  258.      game are in the Door itself and are pretty self explanatory.
  259.  
  260.      You can RESET the entire game by using the included GANGCFG.EXE.  
  261.  
  262.      If you find that the Bathroom Wall is getting rather cluttered
  263.      with player ramblings, you can always reset this simply be 
  264.      deleting WALL.DAT in the main GANGLAND WARS directory.  The next
  265.      time a user tries to read the wall, GANGLAND WARS will create a
  266.      new file if one does not exist.
  267.      
  268.      If at any time you wish to change the configuration for any 
  269.      node, then simply run GANGCFG.EXE again.   
  270.  
  271.      
  272.      ┌─USER ENTERED─BAD─WORDS─────────────────────────────────────13─┐
  273.      └───────────────────────────────────────────────────────────────┘
  274.  
  275.      BADWORDS.LST is included with the GANGLAND WARS archive.  In this
  276.      file you will find some words that most would not find acceptable
  277.      on a public BBS.  If you wish, you can add to this file at any 
  278.      time.  The format is a standard ASCII text file with each word
  279.      on a single line in quotations:
  280.  
  281.      "SHOOT"
  282.      "DARN"
  283.      "FUDGE"
  284.      
  285.      There should not be any blank lines in BADWORDS.LST and all words
  286.      MUST be in CAPS and in QUOTATIONS.  If BADWORDS.LST exists, 
  287.      GANGLAND WARS will check the file when a user enters a thought for
  288.      the BATHROOM WALL.  If any of the words or derivitives are found in
  289.      what the user entered, then the users entry will simply be ignored.
  290.  
  291.      If you run an ADULT BBS and don't care what the users say here, then
  292.      just delete BADWORDS.LST and checking will be disabled.
  293.      
  294.      
  295.      ┌─ERRORS─AND─OTHER─PROBLEMS──────────────────────────────────14─┐
  296.      └───────────────────────────────────────────────────────────────┘
  297.  
  298.      If unusual ERROR's seem to be cropping up right off that start of 
  299.      GANGLAND WARS like a keyboard timeout when the user or even YOU 
  300.      enter the door, there is an easy fix for this problem. Simply 
  301.      place the following line in your AUTOEXEC.BAT file:
  302.  
  303.      SET NO87=ON
  304.  
  305.      One other important thing to note is if you for some reason use 
  306.      the F5 key (SHELL to DOS) while a user is online, before typing 
  307.      "EXIT" to return back into the program, you should always make 
  308.      your way back to the directory that the F5 key dropped you into.  
  309.      Otherwise, GANGLAND WARS won't know how to make its way back to 
  310.      where it needs to be!  This is a routine written by the author of 
  311.      the DOOR LIBRARY, which I have no control over!
  312.  
  313.      ANY other ERROR's while the door is in operation will be written 
  314.      to a file called GANGLAND.ERR.  This ERROR log will be written in 
  315.      the main GANGLAND WARS directory.
  316.  
  317.      If for some reason you see the door say "You need ANSI to use 
  318.      this door!" upon logon and you DO have ANSI enabled, you most 
  319.      likely are running in a DESQview or WINDOWS environment.  It is 
  320.      not good enough to load your ANSI emulator (ANSI.SYS is preferred) 
  321.      in each session or screen, it MUST be loaded upon system start 
  322.      up.  The ANSI routines again, are written by the LIBRARY author, 
  323.      not myself.  I do not have any control over this. :)
  324.  
  325.